Skip to content

docs: state the ABI=Idris2 / FFI=Zig baseline explicitly#52

Merged
hyperpolymath merged 1 commit into
mainfrom
claude/abi-ffi-adapter-policy
Jul 17, 2026
Merged

docs: state the ABI=Idris2 / FFI=Zig baseline explicitly#52
hyperpolymath merged 1 commit into
mainfrom
claude/abi-ffi-adapter-policy

Conversation

@hyperpolymath

Copy link
Copy Markdown
Owner

Summary

Documents the estate's ABI/FFI baseline in .claude/CLAUDE.md, grounded in code I actually verified rather than assumed: the gossamer-mcp/k9iser-mcp cartridge templates in boj-server-cartridges and the Hexadeca-Connector pattern in hypatia/proven-servers.

  • Any ABI must be Idris2; this repo's own src/abi/FeedbackOTron/Contract.idr already complies (real, proofs.yml-checked).
  • Any FFI must be Zig; ffi/zig/src/main.zig is a labeled stub, no substitution.
  • The Zig "unified adapter" protocol-bridge layer is a boj-cartridge concept (documented fully in boj-server/boj-server-cartridges); this repo is the wrapped engine, not the cartridge, so it doesn't carry an adapter/ of its own — noted explicitly to avoid future confusion.
  • Naming lineage: the fuller 16-surface "Hexadeca-Connector" pattern (real, in hypatia/proven-servers) descends from a retired V-lang reference in developer-ecosystem, replaced per the estate's V-lang ban (2026-04-10).

Doc-only change; no code touched.

🤖 Generated with Claude Code

https://claude.ai/code/session_017LDhR8gtnittEWSafunnrq


Generated by Claude Code

Verified against the estate's actual convention (gossamer-mcp / k9iser-mcp
cartridge templates in boj-server-cartridges, and the Hexadeca-Connector
pattern in hypatia/proven-servers) rather than assumed. This repo's own
src/abi/FeedbackOTron/Contract.idr and ffi/zig/src/main.zig already comply;
this documents why, and notes the 'unified adapter' Zig protocol-bridge
layer is a boj-cartridge concept this repo doesn't carry directly (it's the
wrapped engine, not the cartridge).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017LDhR8gtnittEWSafunnrq
@hyperpolymath
hyperpolymath marked this pull request as ready for review July 17, 2026 16:18
@hyperpolymath
hyperpolymath merged commit f81ff09 into main Jul 17, 2026
23 checks passed
@hyperpolymath
hyperpolymath deleted the claude/abi-ffi-adapter-policy branch July 17, 2026 16:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants